home *** CD-ROM | disk | FTP | other *** search
/ Super Shareware Collection / Super Shareware Collection.iso / os_2 / clisp.zip / CLISP.MAN < prev    next >
Text File  |  1994-02-05  |  7KB  |  199 lines

  1.  
  2.  
  3.  
  4. CLISP(1)                                                 CLISP(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        clisp - Common Lisp language interpreter and compiler
  9.  
  10. SSYYNNOOPPSSIISS
  11.        cclliisspp  [  --hh  ]  [ --mm _m_e_m_s_i_z_e ] [ --MM _m_e_m_f_i_l_e ] [ --qq ] [ --ii
  12.        _i_n_i_t_f_i_l_e ...  ] [ --cc [ --ll ] _l_i_s_p_f_i_l_e ...  ] [  --xx  _e_x_p_r_e_s_-
  13.        _s_i_o_n ]
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.        Invokes the common lisp interpreter and compiler.  Invoked
  17.        without arguments, executes  a  read-eval-print  loop,  in
  18.        which  expressions  are  in turn read from standard input,
  19.        evaluated by the lisp interpreter, and their results  out-
  20.        put  to  standard  output.  Invoked with --cc, the specified
  21.        lisp files are compiled to a bytecode that can be executed
  22.        more efficiently.
  23.  
  24. OOPPTTIIOONNSS
  25.        --hh     Displays a help message on how to use cclliisspp.
  26.  
  27.        --mm _m_e_m_s_i_z_e
  28.               Sets  the  amount  of memory cclliisspp tries to grab on
  29.               startup.  The amount may be given as _n_n_n_n_n_n_n  (mea-
  30.               sured in bytes), _n_n_n_nKK or _n_n_n_nKKBB (measured in kilo-
  31.               bytes)  or  _nMM  or  _nMMBB  (measured  in  megabytes).
  32.               Default  is  2.5  megabytes.   The argument is con-
  33.               strained between 100 KB and 16 MB.  -- This version
  34.               of  _c_l_i_s_p allocates memory dynamically.  _m_e_m_s_i_z_e is
  35.               essentially ignored.
  36.  
  37.        --MM _m_e_m_f_i_l_e
  38.               Specifies the initial memory image.  This must be a
  39.               memory dump produced by the _s_a_v_e_i_n_i_t_m_e_m function.
  40.  
  41.        --qq     Quiet:  cclliisspp  displays no banner at startup and no
  42.               good-bye message when quitting.
  43.  
  44.        --ii _i_n_i_t_f_i_l_e _._._.
  45.               Specifies initialization  files  to  be  _l_o_a_ded  at
  46.               startup. These should be lisp files (source or com-
  47.               piled).
  48.  
  49.        --cc _l_i_s_p_f_i_l_e _._._.
  50.               Compiles the specified lispfiles to  bytecode.  The
  51.               compiled  files  can  then be _l_o_a_ded instead of the
  52.               sources to gain efficiency.
  53.  
  54.        --ll     A bytecode listing of the files being compiled will
  55.               be produced.  Useful only for debugging purposes.
  56.  
  57.        --xx _e_x_p_r_e_s_s_i_o_n_s
  58.               Executes  a series of arbitrary expressions instead
  59.               of a  read-eval-print  loop.   The  values  of  the
  60.               expressions will be output to standard output.  Due
  61.  
  62.  
  63.  
  64.                           26 August 1993                        1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CLISP(1)                                                 CLISP(1)
  71.  
  72.  
  73.               to the argument processing done by the  shell,  the
  74.               _e_x_p_r_e_s_s_i_o_n_s  must be enclosed in single quotes, and
  75.               double quotes and backslashes must be  preceded  by
  76.               backslashes.
  77.  
  78.        @@_o_p_t_i_o_n_f_i_l_e
  79.               substitutes  the  contents  of  _o_p_t_i_o_n_f_i_l_e as argu-
  80.               ments. Each line of _o_p_t_i_o_n_f_i_l_e is treated as a sep-
  81.               arate argument to cclliisspp.
  82.  
  83.  
  84. RREEFFEERREENNCCEE
  85.        The language implemented conforms to
  86.               Guy L. Steele Jr.: Common Lisp - The Language.
  87.               Digital Press. 1st edition 1984, 465 pages.
  88.               ("CLtL1" for short)
  89.        and to the older parts of
  90.               Guy L. Steele Jr.: Common Lisp - The Language.
  91.               Digital Press. 2nd edition 1990, 1032 pages.
  92.               ("CLtL2" for short)
  93.  
  94. UUSSEE
  95.        hheellpp   to get some on-line help.
  96.  
  97.        ((aapprrooppooss _n_a_m_e))
  98.               lists the symbols relating to _n_a_m_e.
  99.  
  100.        ((eexxiitt)) or ((qquuiitt)) or ((bbyyee))
  101.               to quit cclliisspp.
  102.  
  103.        EOF (Ctrl-Z)
  104.               to leave the current read-eval-print loop.
  105.  
  106.        arrow keys
  107.               for editing and viewing the input history.
  108.  
  109.        Tab key
  110.               to  complete the symbol's name you are just typing.
  111.  
  112. FFIILLEESS
  113.        _l_i_s_p_._e_x_e
  114.               main executable
  115.  
  116.        _l_i_s_p_i_n_i_t_._m_e_m
  117.               initial memory image
  118.  
  119.        _c_o_n_f_i_g_._l_s_p
  120.               site-dependent configuration
  121.  
  122.        _*_._l_s_p  lisp source
  123.  
  124.        _*_._f_a_s  lisp code, compiled by cclliisspp
  125.  
  126.        _*_._l_i_b  lisp source library information, generated and used
  127.  
  128.  
  129.  
  130.                           26 August 1993                        2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. CLISP(1)                                                 CLISP(1)
  137.  
  138.  
  139.               by the cclliisspp compiler
  140.  
  141. EENNVVIIRROONNMMEENNTT
  142.        CCOOMMSSPPEECC (DOS, OS/2 implementations only)
  143.               is  used  to find the command interpreter called by
  144.               the function _s_h_e_l_l.
  145.  
  146.        TTEERRMM   specifies the terminal emulation cclliisspp  relies  on.
  147.               If  you  have  ANSI.SYS loaded, possible values are
  148.               _a_n_s_i, _a_n_s_i_-_c_o_l_o_r_-_2, _a_n_s_i_-_c_o_l_o_r_-_3 and _m_o_n_o.
  149.  
  150.        TTEERRMMCCAAPP
  151.               should be set to the slashified file  name  of  the
  152.               terminal capabilities database _t_e_r_m_c_a_p_._d_a_t.
  153.  
  154. SSEEEE AALLSSOO
  155.        _c_m_u_l_i_s_p(1), _e_m_a_c_s(1).
  156.  
  157. BBUUGGSS
  158.        The function _i_n_s_p_e_c_t is not implemented.
  159.  
  160.        Only very few extensions from CLtL2 are supported.
  161.  
  162.        No  on-line  documentation  beyond _a_p_r_o_p_o_s and _d_e_s_c_r_i_b_e is
  163.        available.
  164.  
  165.        Stack overflow aborts the  program  ungracefully,  with  a
  166.        register dump.
  167.  
  168.        Pressing Control-C may not interrupt cclliisspp in every situa-
  169.        tion.
  170.  
  171.        Calling the function EXECUTE on batch  files  crashes  the
  172.        machine.
  173.  
  174. PPRROOJJEECCTTSS
  175.        Writing on-line documentation.
  176.  
  177.        Building  a  foreign function interface (ability to call C
  178.        code directly).
  179.  
  180.        Write _i_n_s_p_e_c_t.
  181.  
  182.        Enhance the compiler such that it can inline  local  func-
  183.        tions.
  184.  
  185.        Specify  a portable set of window and graphics operations.
  186.  
  187. AAUUTTHHOORRSS
  188.        Bruno  Haible   <haible@ma2s2.mathematik.uni-karlsruhe.de>
  189.        and Michael Stoll.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                           26 August 1993                        3
  197.  
  198.  
  199.